home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1999 July / Software of the Month - Ultimate Collection Shareware 263.iso / mac / Games / BlockForge / Documentation / Creating your own themes.text < prev    next >
Text File  |  1999-02-18  |  3KB  |  84 lines
  1. Creating your own themes
  2. ========================
  3.  
  4. BlockForge allows you to customize most parts of the game by
  5. Themes. Themes are files in the "Themes" folder, which should
  6. be in your BlockForge folder.
  7.  
  8. The parts that can be customized with themes are:
  9.  
  10. Ñ In-game interface and graphics
  11. Ñ Backgrounds
  12. Ñ Look of blocks (Tilesets)
  13. Ñ In-game sound effects
  14.  
  15. To create your own theme, you need:
  16.  
  17. Ñ ResEdit (available free from Apple), or other resource editor
  18. Ñ Some graphics editor
  19. Ñ (Optionally also a sound editor for creating sounds)
  20.  
  21. There is one theme included with the game, the "Default Theme".
  22. Open it with ResEdit to see how it works.
  23.  
  24. Theme Files
  25. ===========
  26.  
  27. Theme files have creator "BFrg" and type "Mod─".
  28. Requiced contents of a theme file:
  29.  
  30. Ñ tls# resource 128           <-- List of Tilesets
  31. Ñ bgp# resource 128           <-- List of background images
  32. Ñ PICT resources 500 and 501  <-- Interface graphic and mask
  33. Ñ PICT resource 504           <-- "Game Paused" picture
  34. Ñ PICT resource 505           <-- "Game Over" picture
  35.  
  36. Templates for these two resources are included with the Default
  37. Theme.
  38. Both of these resources are lists of PICT resource ID numbers.
  39. For each ID number there should be corresponding PICT resources.
  40. Look the default for example of this.
  41.  
  42. For each tls# entry, you should include a string in STR# resource
  43. ID 128. Look the default theme for an example.
  44.  
  45. Optional contents of a theme file:
  46.  
  47. Ñ snd  resources 200-208  <-- Replacements for built-in sound effects
  48.  
  49. Sample file structure
  50. =====================
  51.  
  52. Here is the structure of "Default Theme" file:
  53.  
  54. Resource "tls#" ID = 128    <-- List of tilests
  55. ---1# = 506
  56. ---2# = 507
  57. Resource "bgp#" ID = 128    <-- List of background pictures
  58. ---1# = 600
  59. ---2# = 601
  60. ---3# = 602
  61. ---4# = 603
  62. Resource "STR# ID = 128     <-- Contains names for Tilesets
  63. ---1# = "Default Tiles"
  64. ---2# = "Diamond Tiles"
  65. Resource "PICT" ID = 500    <-- Interface
  66. Resource "PICT" ID = 501    <-- Mask for interface
  67. Resource "PICT" ID = 506    <-- Contains picture of Tileset
  68. Resource "PICT" ID = 507    <-- Contains picture of Tileset
  69. Resource "PICT" ID = 600    <-- Contains background picture
  70. Resource "PICT" ID = 601    <-- Contains background picture
  71. Resource "PICT" ID = 602    <-- Contains background picture
  72. Resource "PICT" ID = 603    <-- Contains background picture
  73. Resource "snd " ID = 200    <-- Sound effect for piece drop
  74. Resource "snd " ID = 201    <-- Sound effect for zapping 1 row
  75. Resource "snd " ID = 202    <-- Sound effect for zapping 2 rows
  76. Resource "snd " ID = 203    <-- Sound effect for zapping 3 rows
  77. Resource "snd " ID = 204    <-- Sound effect for zapping 4 rows
  78. Resource "snd " ID = 205    <-- Sound effect for highscore
  79. Resource "snd " ID = 206    <-- Sound effect for completing level
  80. Resource "snd " ID = 207    <-- Sound effect for game over
  81. Resource "snd " ID = 208    <-- Sound effect for pausing game
  82.  
  83. -----------
  84. That's all.